package com.jinbooks.persistence.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.jinbooks.entity.marketing.MarketingCampaign;

import java.util.List;

/**
 * 营销活动Service接口
 */
public interface MarketingCampaignService {

    /**
     * 保存营销活动
     *
     * @param marketingCampaign 营销活动实体
     * @return boolean 是否保存成功
     */
    boolean saveCampaign(MarketingCampaign marketingCampaign);

    /**
     * 保存并执行营销活动
     *
     * @param marketingCampaign 营销活动实体
     * @return boolean 是否保存并执行成功
     */
    boolean saveAndExecuteCampaign(MarketingCampaign marketingCampaign);
    
    /**
     * 分页查询营销活动
     *
     * @param page 分页对象
     * @param marketingCampaign 查询条件
     * @return IPage<MarketingCampaign> 分页结果
     */
    IPage<MarketingCampaign> pageList(Page<MarketingCampaign> page, MarketingCampaign marketingCampaign);
    
    /**
     * 根据ID获取营销活动详情
     *
     * @param id 营销活动ID
     * @return MarketingCampaign 营销活动详情
     */
    MarketingCampaign getCampaignById(Long id);
    
    /**
     * 更新营销活动
     *
     * @param marketingCampaign 营销活动实体
     * @return boolean 是否更新成功
     */
    boolean updateCampaign(MarketingCampaign marketingCampaign);
    
    /**
     * 根据ID删除营销活动
     *
     * @param id 营销活动ID
     * @return boolean 是否删除成功
     */
    boolean deleteCampaignById(Long id);
    
    /**
     * 批量删除营销活动
     *
     * @param ids 营销活动ID列表
     * @return boolean 是否删除成功
     */
    boolean deleteCampaignByIds(List<Long> ids);
    
    /**
     * 调度执行营销活动
     *
     * @param marketingCampaign 营销活动实体
     * @throws Exception 调度异常
     */
    void scheduleCampaignExecution(MarketingCampaign marketingCampaign) throws Exception;
}